home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / cnet / cnet_who.lha / WHO_README! < prev   
Text File  |  1995-10-15  |  33KB  |  730 lines
  1. ============================================================================
  2.                CNet WHO's, v2.51 from Frontiers BBS! by Dotoran
  3. ============================================================================
  4.  
  5. What Is It?
  6. ~~~~~~~~~~~
  7.     This is the WHO replacement package you've been waiting for! Especially
  8. if you're a multi-line SysOp, as these are the FIRST EVER external WHO files
  9. that EXACTLY MIMIC CNet's WHO commands in ALL ways, including HIDDEN users!
  10.  
  11.     You will find three versions of the WHO command, each with it's own list
  12. of features:
  13.  
  14. "Short Who" - The "W" Command:
  15.  ~~~~~~~~~         ~
  16.     - Port Number (Scans ALL Loaded Ports. Will only display IDLE ports if
  17.                    you have this enabled through CNet's CONFIG program!)
  18.     - User's Handle
  19.     - Where the User IS in your System!
  20.     - Conference Control Flag (+) Supported 100%. (This means that users on
  21.       other ports who try to Hide or Muffle a Conf. Controller will appear
  22.       to do so on THEIR screens, but will FAIL to do so on the Controller's
  23.       WHO screen, just like CNET!)
  24.     - Hiding "h", and Muffling "m" fully supported.
  25.     - Attempted Hiding "H", and Attempted Muffling "M" also supported!
  26.       (This is what a Conference Controller will see on their WHO screens
  27.        of user's who are trying to Hide or Muffle them!)
  28.     - Idle Ports now have the ability to show how LONG they've been Idle,
  29.       provided you have "Show Idle Ports" set in CONFIG!
  30.     - Occupied Ports that have been IDLE for LONGER than 5 minutes now tell
  31.       you this, so that you can get an idea as to whether or not the user
  32.       on the port is REALLY there or not!
  33.     - Fully colorized, with two separate HELP menus for beginning users!
  34.  
  35.  
  36. "Normal Who" - The "WH" Command:
  37.  ~~~~~~~~~~         ~~
  38.     - Contains everything the "Short" format does, PLUS:
  39.     - Logon Time.
  40.     - Current CPS Rate (Baud/100).
  41.     - City, State, and Country User Hails From.
  42.     - User's Short, Internal CNet WHO Banner!
  43.     - Idle Ports can now use an optional IDLE Banner, a line of up to 54
  44.       characters that could possibly tell such info as phone numbers, baud
  45.       rates, times, etc. If an Idle Banner is NOT created, the user will be
  46.       shown the regular "<No One>  0  Idle" line instead, unless a DEFAULT
  47.       Idle Banner has also been created.
  48.  
  49.  
  50. "Long Who" - The "WHO" Command:
  51.  ~~~~~~~~         ~~~
  52.     - Contains all "Short" and "Normal" information, PLUS:
  53.     - Last Call Date.
  54.     - Gender of User (Male or Female)[Color Coded Blue or Red]
  55.     - Time Used Online TODAY (in Minutes)
  56.     - The User's 3-Line "Glimpse" file.
  57.     - A History Flag "*" Telling which Users Have History Files, which are
  58.       text files of up to 20-Lines!
  59.  
  60. ----------------------------------------------------------------------------
  61.     Of course, all appear in the FRONTIERS BBS Color Scheme, but can easily
  62. be changed by using the included CONFIG file.
  63.  
  64.     All three versions of the command may also take numeric arguments, which
  65. act just like CNet's built-in versions. These numbers represent the PORTS in
  66. which you wish to scan, like these examples illustrate:
  67.  
  68.     W 0-2             : Short WHO for Ports 0 thru 2.
  69.     WH 1 4 10         : Normal WHO for Ports 1, 4, and 10.
  70.     WHO 0-2,5.9 12-   : Long WHO for Ports 0 thru 2, 5, 9, and all Ports
  71.                         from 12 thru your Highest Loaded Port.
  72.  
  73.     Note that ALL forms of arguments are allowed:  2  0,3  1-4,  2.5.8, etc.
  74.  
  75.     Provided the user has the "Conference Control" flag set in their account,
  76. they may also specify the <C>onfig argument to load the CONFIG file:
  77.  
  78.     W C     : Load CONFIG, ready to Edit Short Who data.
  79.     WH C    : Load CONFIG, ready to Edit Normal Who data.
  80.     WHO C   : Load CONFIG, ready to Edit Long Who Data.
  81.               This version also allows for ALL Versions to be Created.
  82.  
  83.     You can type as much of the word CONFIG as you wish, but only the first
  84. letter will be looked at, so the following would also load the CONFIG:
  85.  
  86.     W CONFIG
  87.     WH CON
  88.     WHO C
  89.  
  90.     Also, when using the "Long" Who version, there are three more arguments
  91. that can be used to SKIP the WHO Listing and immediately enter one of the
  92. Long Who prompt commands. Again, you may type as MUCH of the keyword as you
  93. wish, but only the first letter is scanned:
  94.  
  95.     WHO B   (or WHO BANNERS, etc.) to edit/pick a Short Who Banner!
  96.     WHO G   (or WHO GLIMPSE, etc.) to edit their Glimpse File!
  97.     WHO H   (or WHO HISTORY, etc.) to edit their History File!
  98.     WHO V   (or WHO VIEW, etc.)    to edit their History File also!
  99.  
  100.     In addition, these NEW arguments have been added into v2.1c. Two are for
  101. Conference Controllers ONLY, and the other two are for ALL users:
  102.  
  103.     Conference Controllers ONLY:
  104.   ================================
  105.  
  106.     WHO I   (or WHO IDLES, etc.)   to ReLoad your Idle Who Banners!
  107.  
  108.     WHO E   (or WHO EDIT, etc.)    to Modify your Idle Who Banners!
  109.  
  110.         - The editor is entered, giving you 102 lines. This is to allow for
  111.           100 lines of regular ports, 1 line for a default banner, and 1
  112.           line for the Total Banners on file.
  113.  
  114.     Available to ALL Your Users:
  115.   ================================
  116.  
  117.     WHO P   (or WHO PORT, etc.)    to display CURRENT PORT's Idle Banner.
  118.  
  119.         - This comes in handy when a user wishes to know which phone number
  120.           they happened to call in on, etc.
  121.  
  122.     WHO Q   (or WHO QUICK, etc.)   to QUICK display the "Long" output.
  123.  
  124.         - "Quick" display will suppress the printing of Glimpses, lines of
  125.           separator characters BETWEEN each port, as well as any HELP MENUS
  126.           that may need to be printed, and finally the options prompt. What
  127.           is RETAINED is the Last Call Date, User Gender, History Flag and
  128.           Total Time Online Today, which is NOT shown in the "Normal" file.
  129.  
  130.     Lastly, all WHO's should be able to be aborted by pressing ANY key while
  131. they are displaying, without having to wait for the ENTIRE listing to be
  132. shown. Better support for this cancelling was added to v2.51 CNet Who!
  133.  
  134.  
  135. How Do I Install It?
  136. ~~~~~~~~~~~~~~~~~~~~
  137. 1: Copy the "Who/" directory into your PFILES: area.
  138.  
  139. 2: Load your BBSMENU text file, found in the CNET: path, into any text editor
  140.    and make the following changes:
  141.  
  142.         A: Locate Menu # 2, Available Everywhere Menu, and find the entry
  143.            line containing the text "Who" and place a "2" in FRONT of this
  144.            text, so that the text now reads "2Who".
  145.  
  146.         B: At the BOTTOM of this Menu, add the following three lines:
  147.  
  148.                 WHO    `1- | {#0 pfiles:Who/Long}
  149.                 WHo    `1- | {#0 pfiles:Who/Normal}
  150.                 Who    `1- | {#0 pfiles:Who/Short}
  151.                              |
  152.                              `---> A Control-Q character.
  153.  
  154.            NOTE: The CAPITALIZATION of the word "WHO" is VERY important in
  155.                  these three lines. The W, H, and O should ALL be UPPERCASE
  156.                  in the FIRST line, while only the W and H in the SECOND
  157.                  line, and ONLY the W in the THIRD line.
  158.  
  159.         C: Since CNet's built-in WHO command looks almost IDENTICAL to MY
  160.            "Normal WHo" version, I choose to use CNet's version instead of
  161.            mine. I do this, mainly for speeds sake. To make YOUR System use
  162.            CNet's WHO for the SECOND version, change the SECOND line above,
  163.            so that it reads like this:
  164.  
  165.                 WHo    `1- | {& 2Who}
  166.                              |
  167.                              `---> A Control-Q character.
  168.  
  169.            NOTE: The "2Who" text, inside the {& } command, should appear the
  170.                  EXACT same as it appears in the BBSMENU file, as you changed
  171.                  it in step "A" above. That is, only the "W" should be
  172.                  capitalized.
  173.  
  174.         D: Locate the "Write" command in the following Menus:
  175.  
  176.                 4; ud/base
  177.                 5; Respond or Pass?
  178.                 7; Read mail
  179.                 20; Browse
  180.  
  181.            You must change the TEXT of this command, so that it reads:
  182.  
  183.                 WRite       instead of      Write
  184.                  |
  185.                  `---> Make this "R" UPPERCASE.
  186.  
  187.            This is a needed change, because unless you make this change, the
  188.            WRITE command will NOT function in these areas if the user types
  189.            "W" to change the description of a file, or enter the editor with
  190.            the current mail message(They'll be shown the SHORT WHO instead!)
  191.  
  192.         E: You will also want to update the following HELP files, which can
  193.            be found inside your "SysText:Help/" directory to reflect the
  194.            change you made in step "D" above:
  195.  
  196.                 udbase - Goes with Menu # 4
  197.                 mail2  - Goes with Menu # 5
  198.                 post   - Goes with Menu # 7
  199.  
  200.            I checked the "browse" help file, but noticed the WRITE command
  201.            was not included in that file, so no changes are needed to that
  202.            file. To make the change, the line in question starts with:
  203.  
  204.                 \c7W\c6rite ...etc.
  205.  
  206.            Change it, so it looks like this:
  207.  
  208.                 \c7WR\c6ite ...etc.
  209.                 |    |
  210.                 `----`---> Remember, these are Control-Y characters!
  211.  
  212.         F: Load your BBSTEXT file into a text editor, then go to line 62 of
  213.            that file. It looks like this(in a stock 3.05c bbstext):
  214.  
  215.                         \n1@ Cleared for logon\n1
  216.                         |                     |
  217.                         `---- Control-Y's ----'
  218.  
  219.            To the end of this line, add the following:
  220.  
  221.                         {#0 pfiles:who/loader}
  222.                         ^
  223.                     Control-Q
  224.  
  225.            This will insure that the IdlePort Banners are loaded, as well
  226.            as updating the user's multiple who banners(if allowed).
  227.  
  228.         G: Edit the "IdlePorts" text file, located inside the "pfiles:Who/"
  229.            directory to contain the Idle Banners you wish to use. The format
  230.            of the file is fairly loose:
  231.  
  232.                 Line 1: Should contain a number, followed by at LEAST one
  233.                         SPACE, then any other text you wish. This NUMBER is
  234.                         the total number of lines BELOW that will be read
  235.                         into the computer the FIRST time someone logs onto
  236.                         the bbs AFTER this mod has been installed.
  237.  
  238.               Line 2-?: a|b
  239.                         ||`--> Idle Banner Text.
  240.                         |`---> Pipe (Vertical Bar) [To Right of Equals Sign]
  241.                         `----> The Port Number.
  242.  
  243.                     eg: 1|Line # 1, SupraFAX 28.8 (716)/823-9892
  244.  
  245.                  NOTE1: The port numbers do NOT have to come in ORDER in the
  246.                         file. Use whichever order best suits your need!
  247.  
  248.                  NOTE2: Starting the line with a "D" (minus the quotes),
  249.                         instead of a Port Number will define the DEFAULT
  250.                         Idle Banner to use for any ports that may be loaded,
  251.                         but that do NOT contain a premade Idle Banner.
  252.  
  253.         G: That's it! You're Done! You can RELOAD your BBSMENU and BBSTEXT
  254.            files by using the RAMIGA-T key combination!
  255.  
  256. What's This LONG WHO Command Menu?
  257. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  258.     Well, let's look at the command menu that appears BELOW the Long WHO's
  259. listing:
  260.  
  261.             Long Who [B]anner, [G]limpse, [V]iew History, or [QUIT]:
  262.  
  263.     From the above command menu, four commands are possible:
  264.  
  265. "[B]anner"
  266.  
  267.     - Allows the user to, then and there, edit the contents of their current
  268.       short CNet WHO Banner. (The same one available for editing via EP;14).
  269.       Their existing WHO Banner is displayed for the user as the default, so
  270.       they can make either small changes, or simply delete the whole thing
  271.       and start it over again.
  272.  
  273.     - The user is also allowed to enter MCI-Color Codes into their short
  274.       WHO Banner, using Control-Y type MCI codes.
  275.  
  276.             - NOTE: See the info below dealing with TOGGLE settings for more
  277.                     info on how you wish MCI's supported in the Who Banners.
  278.  
  279.     - They can also use the following SPECIAL Key-Strokes for editing:
  280.  
  281.             - CONTROL-X : Deletes EVERYTHING in the string gadget.
  282.             - CONTROL-B : Move Cursor to the Beginning of the string.
  283.             - CONTROL-N : Move Cursor to the eNd of the string.
  284.             - BACKSPACE : Delete character to LEFT of cursor, then move the
  285.                           cursor INTO that position.
  286.             - DELETE    : Will PULL text to the RIGHT of the cursor INTO the
  287.                           cursor, deleting characters as it goes.
  288.  
  289.     - For v2.0, this section received a bit more power, because NOW when the
  290.       user presses "B", they are taken to a NEW screen that allows them to
  291.       create MULTIPLE Short WHO Banners, up to TEN in all. They may choose
  292.       to EDIT any of them, using the techniques above, and can even swap the
  293.       "Current" Banner their using, in which case the NEW Banner would also
  294.       be permanently written to their user account(thus editable via EP;14).
  295.  
  296.     - You may disable this feature through the CONFIG file.
  297.  
  298.     - The user's Short Who Banners are stored in a file called "_Banners",
  299.       which is stored in the user's uucp mail directory inside the cnet
  300.       "mail:users/" directory.
  301.  
  302.     - For v2.1, the Loader was modified to perform a "Pick Banner" operation
  303.       whenever the user signs onto your board, PROVIDED a "Banners" file is
  304.       found for that user. This way, if they are using multiple different
  305.       banners, each call will activate a NEW banner for them, without the
  306.       user having to do it manually via "WHO B;P".
  307.  
  308. "[G]limpse"
  309.  
  310.     - The "Glimpse" files are three 78-character lines, EXCLUDING the Short
  311.       WHO Banner, that the user may create listing more info they want other
  312.       users to know about. These "Glimpse"'s are shown on the LONG version
  313.       who screen only.
  314.  
  315.     - The user is given the FULL POWER of the CNet Amiga Text Editor to enter
  316.       whatever they wish for their 3-Line "Glimpse" file. Use of ANY MCI's
  317.       the user has access to is fully supported.
  318.  
  319.     - If a user wishes to DELETE a "Glimpse" file, they should first enter
  320.       the editor with it, then DELETE it from the editor, using the .N
  321.       command, then SAVE the EMPTY editor. They will THEN be given a prompt
  322.       asking if they wish to DELETE the "Glimpse" file.
  323.  
  324.     - The Glimpse file is stored as "_Glimpse" in the user's uucp directory,
  325.       in the same way the banners are.
  326.  
  327.     - If a user does not have a "_Glimpse" file created in their uucp mail
  328.       directory, then the default glimpse file will be displayed when the
  329.       LONG who version is used, however this default file is NOT stored in
  330.       the user's uucp directory, but exists as "pfiles:who/_Glimpse".
  331.  
  332. "[H]istory"
  333.  
  334.     - You'll be given another command prompt when this command is used:
  335.  
  336.             [E]dit, [V]iew by Port, or [S]pecific Histories? [QUIT]:
  337.  
  338.     - If you choose to "[E]dit" your History file, any existing History will
  339.       be loaded into the CNet Editor, and you'll be given 20-Lines to enter
  340.       anything you'd like. The same editor features as the "Glimpses" are
  341.       allowed for use with "History" files.
  342.  
  343.     - If a user wishes to DELETE a "History" file, they should first enter
  344.       the editor with it, then DELETE it from the editor, using the .N
  345.       command, then SAVE the EMPTY editor. They will THEN be given a prompt
  346.       asking if they wish to DELETE the "History" file.
  347.  
  348.     - Pressing "[V]iew by Port" allows the user to view the History of a
  349.       user signed onto another port. Checks are made to insure their IS a
  350.       user on that port, and that the port is LOADED.
  351.  
  352.     - If you choose "[S]pecific Histories", you'll be asked to enter either
  353.       the ID Number, Handle, or Real Name of the user to view the History of.
  354.       If an incomplete Real Name or Handle is entered, you'll be shown the
  355.       User List menu, and can then choose the proper name off the menu. It is
  356.       possible to view your OWN History file by supplying your OWN info here.
  357.  
  358.     - Pressing ENTER/RETURN, or pressing "[Q]uit" will take you back to the
  359.       initial command prompt.
  360.  
  361.     - The History file is stored as "_History" in the user's uucp directory,
  362.       in the same way the banners are.
  363.  
  364.     - If a user does not have a "_History" file created in their uucp mail
  365.       directory, then the default history file will be displayed when the
  366.       LONG who version is used, however this default file is NOT stored in
  367.       the user's uucp directory, but exists as "pfiles:who/_History".
  368.  
  369. "[QUIT]"
  370.  
  371.     - Pressing ENTER/RETURN, or pressing "[Q]uit" will exit the Long Who,
  372.       and return you to the CNet Command Prompt that called WHO.
  373.  
  374. How do I use the CONFIG File?
  375. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  376.     One of the NEW features of v2.0 is the addition of an ANSI-ARexx style
  377. CONFIG program, written to mimic the VDE-type editors you may have seen and
  378. used with CNet before.
  379.  
  380.     You should enter the CONFIG program thru one of the WHO programs. Which
  381. WHO program you use to launch the CONFIG will have a bearing on which data
  382. items you will be able to edit on the various screens within the editor. For
  383. instance, things like Who Banners, Idle Port Banners, Glimpse Files, etc are
  384. not used in the SHORT form WHO program, so will appear as ghosted(black) on
  385. the CONFIG screen, and will not editable.
  386.  
  387.     As mentioned above, use one of the following three commands to load the
  388. CONFIG:
  389.             W C     : Enter CONFIG to edit Short Who data.
  390.             WH C    : Enter CONFIG to edit Normal Who data.
  391.             WHO C   : Enter CONFIG to edit Long Who data.
  392.  
  393.     You can also add the CONFIG file into your PFILES area as an Exclusive
  394. Use Only ARexx Pfile. You must specify an argument of W, WH, or WHO, so that
  395. the CONFIG will know WHICH WHO you wish to edit. Specify WHO if you wish to
  396. edit ALL of them at the same time. If the argument is NOT specified, the
  397. CONFIG file will exit, shortly after loading.
  398.  
  399.     Alright, you know HOW to load the CONFIG, now here's some info pertaining
  400. to certain things within the CONFIG that may need additional clarification:
  401.  
  402. Text String Gadgets:
  403. ~~~~~~~~~~~~~~~~~~~~
  404.     All text string gadgets may use the following SPECIAL key-strokes to aid
  405. in the entering/editing of text:
  406.  
  407.     CONTROL-X : Erase Everything.
  408.     CONTROL-B : Move to Beginning of Text.
  409.     CONTROL-N : Move to End of Text.
  410.     BACKSPACE : Delete Character to LEFT of Cursor.
  411.        DELETE : Pull Character to RIGHT of Cursor INTO the Cursor.
  412.  
  413.     In addition, each string gadget is formatted for the MAXIMIMUM allowed
  414. length that can be used in the Layout.
  415.  
  416. "BG"
  417.  ~~
  418.     Means a BackGround Color, and can be any of the following characters,
  419. which correspond to the equivalent MCI-Z Color Codes:
  420.  
  421.             0, 1, 2, 3, 4, 5, 6, and 7.
  422.  
  423. "FG"
  424.  ~~
  425.     Means a ForeGround Color, and can be any of the following characters,
  426. which correspond to the equivalent MCI-C Color Codes:
  427.  
  428.             0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, d, e, and f.
  429.  
  430. Use of BG and FG:
  431. ~~~~~~~~~~~~~~~~~
  432.     These fields use 1 character string gadgets. After pressing ENTER, you
  433. can do one of two things:
  434.  
  435.     1: Type a NEW value, which will then REPLACE the old value. Press ENTER
  436.        to confirm your choice, or use the BACKSPACE key to delete and try
  437.        again.
  438.  
  439.     2: Press ENTER again, in which case the NEXT value in sequence will be
  440.        used, so if the value WAS "a", it would become a "b". If the value
  441.        was "f", it would turn over and become a "0". A "3" would become a
  442.        "4", etc.
  443.  
  444. Use CNet "Stock" BBS
  445. Use "Frontiers"  BBS
  446. ~~~~~~~~~~~~~~~~~~~~
  447.     These two items allow you to select two built-in default settings. The
  448. "Stock" version is a rather plain looking color combination, while "Frontiers"
  449. is the familiar blue scenario that previous versions have used.
  450.  
  451. Saving Changes Made?
  452. ~~~~~~~~~~~~~~~~~~~~
  453.     The CONFIG uses a "Smart Save" feature, just like CNet's VDE Editors, so
  454. if all you do is load the CONFIG and LOOK at some values, when you select
  455. the "<< Exit" option, you will immediately exit the file, but if changes
  456. have been made, you'll get another screen asking if you'd like to SAVE the
  457. changes you've made.
  458.  
  459. ReLoad "IdlePorts"
  460. ~~~~~~~~~~~~~~~~~~
  461.     If you've made changes to the "IdlePorts" text file, you'll need to
  462. ReLoad them into memory, so that the NORMAL and LONG Who versions will
  463. reflect these changes.
  464.  
  465.     After selecting this option, a second or two will go by, then the screen
  466. should flash and you may hear a beep sound, which alerts you the process has
  467. completed.
  468.  
  469.     NOTE: Remember, as of v2.1c, you can now use "WHO I" to ReLoad the Idle
  470.           Port Banners as well.
  471.  
  472. CREATE SHORT WHO
  473. CREATE NORMAL WHO
  474. CREATE LONG WHO
  475. CREATE ALL WHO FILES
  476. ~~~~~~~~~~~~~~~~~~~~
  477.     Simply SAVING your changes is NOT all you have to do in order to BIND
  478. the changes you've done. When you're satisfied with the color/text choices
  479. you've made(use Show Example LayOuts), then you are ready to CREATE the WHO
  480. file.
  481.  
  482.     You have the option of creating a unique look for EACH of your WHO's, or
  483. you can use the "ALL WHO FILES" (only available in the LONG Who CONFIG) to
  484. use the Long Who settings to create ALL THREE versions.
  485.  
  486.     The CONFIG file actually GENERATES CUSTOM AREXX CODE containing the data
  487. you entered in the CONFIG program. This way, the WHO files execute a LOT
  488. faster than they would if they had to constantly read in a config file, set
  489. up a bunch of variables, then slap the variables into place.
  490.  
  491.     It also allows you to easily be able to EDIT any of the WHO files, if
  492. you find there are some small changes you'd like to make in ADDITION to
  493. those made by the CONFIG, however you need to follow this warning:
  494.  
  495. ***WARNING***
  496. =============
  497.  
  498.     Treat the "Short", "Normal", and "Long" text files the same way you would
  499. treat the BBSTEXT file, in that you should NOT alter the ORDER of the lines
  500. within each of these files.
  501.  
  502.     The "MakeWho" program is written to read in all the lines from each of
  503. these files, then REPLACE certain lines with those containing your CUSTOM
  504. values. ALTERING THE ORDER OR SEQUENCE of any of these files will result in
  505. CATASTROPHIC EVENTS! The "MakeWho" program may NOT be loaded externally by
  506. you through the Pfiles section. The CONFIG program MUST be the one that is
  507. used to call this file. (In other words, LEAVE THIS FILE ALONE!)
  508.  
  509.     Also, UNLIKE the BBSTEXT file, you should NOT alter the CONTENTS of any
  510. of the lines IF you think you'll be using the MAKEWHO program again, as any
  511. changes you make to the actual code MAY not be recreated by the MAKEWHO file,
  512. if the changed line contains an MCI-Color Code. If you note a problem in one
  513. of the lines, please alert me of the fact, so that I can take the proper
  514. steps to edit the MAKEWHO file to also correct the problem when you generate
  515. a NEW who format.
  516.  
  517.     After selecting this option, a few seconds will go by, then the screen
  518. should flash and you may hear a beep sound, which alerts you the process has
  519. completed.
  520.  
  521. Info On Toggle Switches:
  522. ~~~~~~~~~~~~~~~~~~~~~~~~
  523.     Show Idle Minutes
  524.     ~~~~~~~~~~~~~~~~~
  525.         Yes : Displays "Idle ?? Minutes" in WHERE Column.
  526.         No  : Displays "Idle"            in WHERE Column.
  527.  
  528.         NOTE: In v2.1, if set to "Yes", and more than 60 minutes have gone
  529.               by, then the value is recalculated in HOURS and displayed as
  530.               such. Also, if less than 60 minutes, you will also be shown
  531.               the TENTHS of minutes that have gone by, like "13.6 Minutes".
  532.  
  533.     Show Idle Banners
  534.     ~~~~~~~~~~~~~~~~~
  535.         Yes : Displays "IdlePortB?" line, if it exists.
  536.         No  : Displays "<no one>        0"  CNet's Default.
  537.  
  538.     Multiple Banners
  539.     ~~~~~~~~~~~~~~~~
  540.         Yes : Allow User to Use/Edit Multiple Short Who Banners.
  541.         No  : Disable this feature. User will have to resort to EP;14.
  542.  
  543.     Skip Idle Ports
  544.     ~~~~~~~~~~~~~~~
  545.         Yes : Will NOT print Port Info if it's an Idle(Empty) Port.
  546.         No  : Display Idle Port Info.
  547.  
  548.     Skip Hidden Ports
  549.     ~~~~~~~~~~~~~~~~~
  550.         Yes : Will NOT print Port Info if User On that Port is HIDING.
  551.         No  : Will display this port as "appearing to be Idle".
  552.  
  553.         NOTE: When set to "No", CNet WHO uses an interesting trick to show
  554.               the number of minutes the port has been idle. The value used
  555.               here is actually the total number of minutes the CURRENT user
  556.               has been online(added to the FAKE Idle Time discussed below).
  557.  
  558.     Allow Banner MCI's
  559.     ~~~~~~~~~~~~~~~~~~
  560.         A new toggle setting for v2.51 CNet WHO takes one of two settings:
  561.  
  562.         Yes : Allow the user to use MCI commands while creating Who Banners.
  563.         No  : Do NOT allow MCI's to be input into the Who Banners.
  564.  
  565.         NOTE: If this option is set to YES, but the user does not have the
  566.               ACCESS to use MCI's, then any MCI's entered by the user will
  567.               be automatically STRIPPED from the string. Also, if the user
  568.               has MCI-1 Access, but NOT MCI-2 Access, the MCI-2 Level MCI
  569.               codes will be STRIPPED if found.
  570.  
  571.     Allow SysOp  MCI's
  572.     ~~~~~~~~~~~~~~~~~~
  573.         A new toggle setting for v2.51 CNet WHO takes one of two settings:
  574.  
  575.         Yes : Allow System Operators to use SYSOP-ONLY MCI's in Banners.
  576.         No  : SYSOP-ONLY MCI commands will be STRIPPED from Who Banners.
  577.  
  578.         NOTE: A "System Operator" is a user who has this priviledge flag
  579.               set in their user accounts. Lines 4 and 5 in your BBSTEXT file
  580.               determine which commands to deem SYSOP-ONLY(Line 4) and as
  581.               Level 2 MCI's(Line 5). Any commands NOT FOUND on these two
  582.               lines are available to users with Level 1 MCI Access. These
  583.               two lines are automatically read into the CONFIG program each
  584.               time it is used, so as to insure the proper stripping is done.
  585.  
  586.     Clear Screen Before
  587.     ~~~~~~~~~~~~~~~~~~~
  588.         Yes : The Screen is CLEARED BEFORE the WHO info is shown.
  589.         No  : The Screen is NOT cleared before the info is shown.
  590.  
  591.     Empty Port Block
  592.     ~~~~~~~~~~~~~~~~
  593.         Yes : Use following values to SPEED up the printing.
  594.         No  : Follow normal "1x1" iteration method.
  595.  
  596.     Port to Skip FROM
  597.     ~~~~~~~~~~~~~~~~~
  598.         When this port value is reached in the loop, the loop will then
  599.         IMMEDIATELY jump to the following value.
  600.  
  601.     Port to Skip TO
  602.     ~~~~~~~~~~~~~~~
  603.         The value to RESUME scanning for Port data. For instance, with these
  604.         ports set up:  0, 1, 2, 3, 98, and 99, you'd want to specify a "3"
  605.         in the FROM field, and "98" in the TO field, so that the who isn't
  606.         having to scan: 4, 5, 6, 7, 8, 9, 10, etc. etc. etc. up to 98!
  607.  
  608.     Fake Idle Minutes
  609.     ~~~~~~~~~~~~~~~~~
  610.         This value was included as a means of making HIDDEN USERS appear to
  611.         be hidden MORE SO over previous versions. Because these WHO programs
  612.         have the ability to specify how LONG a port has been IDLE, I needed
  613.         a way to fake idle time on HIDDEN ports. Earlier versions had me
  614.         just snagging the number of minutes the CURRENT user was ONLINE and
  615.         using that value, however I discovered that if a user initially logs
  616.         on, then immediately uses a WHO module, they'd see these HIDDEN
  617.         ports as being Idle for 0-1 Minutes, which made it look like these
  618.         ports logged OFF as soon as this user logged ON, so that's where
  619.         this value comes in. This value is ADDED TO the current user's time
  620.         online, and it's this SUM that is used for the IDLE TIME for HIDDEN
  621.         PORTS.
  622.  
  623. Manual Toggle Setting:
  624. ~~~~~~~~~~~~~~~~~~~~~~
  625.     It is also possible to MANUALLY set these toggles in each program by
  626. editing the given line in each version:
  627.  
  628.                           Line
  629.                          ======
  630.                     Short: 14
  631.                    Normal: 15
  632.                      Long: 24
  633.  
  634.     Use values of "1" to represent YES, and "0" to represent NO in these
  635. variables, located on the above lines. If a version doesn't contain the
  636. given variable, then that version doesn't use/support that feature.
  637.  
  638.                         Variable    Toggle It Effects
  639.                         ========    ====================
  640.                            v1       Show Idle Minutes
  641.                            v2       Show Idle Banners
  642.                            v3       Multiple Banners
  643.                            v4       Skip Idle Ports
  644.                            v5       Skip Hidden Ports
  645.                            v6       Empty Port Block
  646.                            loS      Port to Skip FROM
  647.                            hiS      Port to Skip TO (Use hiSk in LONG)
  648.                            v7       Clear Screen Before
  649.                            v8       Allow MCI's in Who Banners?
  650.                            v9       Allow SysOp's to use SysOp-MCI's?
  651.  
  652.     Remember, ALL VARIABLES MUST RESIDE ON THE SAME LINE, as noted in the
  653. table above. Do NOT place them on individual lines, unless you plan on NOT
  654. using the CONFIG program to CREATE new layouts.
  655.  
  656. Is That It?
  657. ~~~~~~~~~~~
  658.     So far as I can tell, YES! I believe I've covered all the bases. I still
  659. have not been able to locate that ETA line used with File Transfers. I've
  660. been able to deduce that the ETA value is calculated "on the fly" as it's
  661. needed, which makes recreating this value a tough chore, as there are many
  662. getusers involved in calculating this value, MOST of which are accessable
  663. with known getusers, however the one key value I can't seem to locate is
  664. how MANY KILOBYTES have ALREADY been DOWNLOADED(or UPLOADED). Without this
  665. value, coming up with a "ball-park" ETA value is not obtainable.
  666.  
  667.     If you notice ANY, and I mean ANY problems with this version, PLEASE get
  668. in touch with me, either on Frontiers, Future World, thru Fido-Net Mail
  669. to "David Weeks@1:260/121", CLink-Net Mail to "David Weeks@911:6840/2.0",
  670. or on the InterNet via "dotoran@buffnet.net".
  671.  
  672.     There WILL be at least ONE more major release, but I can't put a date as
  673. to when you'll be seeing it, as I've got to start on it again from scratch!
  674.  
  675.     Enjoy this work! I put some serious work into it!
  676.                                                                   - Dotoran
  677.  
  678. In The Future?
  679. ~~~~~~~~~~~~~~
  680.     CNet WHO, v3.0 will be a complete rewrite, from the ground up, so that I
  681. can also include a custom DATA LAYOUT screen. What this means is you'll then
  682. be able to "pick and choose" exactly WHICH info you wish to show in each of
  683. your three WHO formats. Here's an ASCII shot of the screen layout I'm working
  684. on right now. This is still pretty sketchy, but you'll get the idea:
  685.  
  686. ---snip starts here---
  687.  
  688.                                Line 1
  689. -A B -C------------------ -J-------------
  690.  
  691. <---10---><---20---><---30---><---40---><---50---><---60---><---70---><--78-->
  692.  
  693. Port Number              Minimum Width: 2   Maximum Width: 4   Centered: Yes
  694. Width: 2   Text Bar: >P#<
  695. ForeGround: 4  BackGround: 6  Reversed: No   Underlined: No   BoldFaced: No
  696.  
  697.   *[A]*Port Number      [M] Last Call Date           [Y] Country Text
  698.    [B] Hide/Muffle Flag [N] Time Used Today          [Z] History Flag
  699.    [C] User Handle      [O] Primary Underscore       [1] Calls By This User
  700.    [D] User Real Name   [P] Secondary Underscore     [2] Balance Owing
  701.    [E] Logon Time       [Q] Total PFile Game Points  [3] Short Who Banner
  702.    [F] Logoff Time      [R] Access Group Number      [4] Glimpse File
  703.    [G] CPS Rate         [S] Access Group Name        [5] User ID Number
  704.    [H] Baud Rate        [T] Total Public Messages    [6] User SID Number
  705.    [I] City Text        [U] Total Uploaded Files     [7] Total File Credits
  706.    [J] Where Location   [V] Total Uploaded Bytes     [8] Total Byte Credits
  707.    [K] Gender Text      [W] Total Downloaded Files   [9] State Text
  708.    [L] Line Width       [X] Total Downloaded Bytes   [0] First Name
  709.  
  710. ---snip ends here---
  711.  
  712.     As you can see, I'm playing around with allowing you to pick from up to
  713. 36 different pieces of information. You can create WHO Layouts of up to 4
  714. lines each, where each line can contain ANY info you wish, in ANY order you
  715. wish, etc. I'm also playing around with the idea of attaching Access Group
  716. restrictions onto each data item, so that the data will only be shown to the
  717. user if their Access Group is high enough. If it's not, they'll just be shown
  718. some dead space in place of the info, or maybe I'll mask out the info. Not
  719. sure yet. I'm also playing around with the idea of creating custom TERMINAL
  720. versions for each file, so you can have ASCII, ANSI, and IBM-ANSI versions
  721. of the WHO files too.
  722.  
  723.     It's still in the planning stages right now, so if you have anything to
  724. ADD to these initial ideas, PLEASE forward them directly to me for inclusion
  725. into the next version!
  726.                                                                    - Dotoran
  727. ============================================================================
  728.                         Frontiers BBS (716)/823-9892!
  729. ============================================================================
  730.